home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 November / macformat-043.iso / mac / Shareware Plus / Developers / OpenStack Rinaldi Collection / openstack-rinaldi-lib / SetMode 1.4 (US) / SetMode 1.4 (US).rsrc / HELP_5635 next >
Encoding:
Text File  |  1996-01-09  |  2.7 KB  |  58 lines
  1.  
  2.  
  3.                                              SetMode 1.4
  4.  
  5.                                           by Frédéric RINALDI
  6.  
  7. DESCRIPTION
  8.   SetMode XCMD allows to switch any connected screen from one video mode and depth to another.
  9.  
  10. SYNTAX
  11.             SetMode <B[lack]|C[olor]>,<1|2|4|8|16|32>[,<screen nb>]
  12.  
  13. PARAMETERS
  14.    <B[lack]|C[olor]> stands for the mode. Only first char is recognized.
  15.  
  16.    <1|2|4|8|16|32> is the video depth, an integer bit value.
  17.  
  18.    <screen nb> is optional, and is an integer standing for the screen number (as returned by GetMode XFCN). If omitted, the changed screen will be the screen on which the card is. Using "*" will change all connected screens to the choosen mode.
  19.  
  20.    Using "!", "?" and "=" as first parameter will return an online help (resp. copyright, syntax and output).
  21.  
  22. USING
  23.    SInce automatic video mode switching is not recommended by Apple Interface Guidelines, don't forget to restore initial mode when leaving the stack (see stack script).
  24.  
  25. ERRORS
  26.    If an error occurs, SetMode can return :
  27.      "Error : Couln't get system informations"
  28.      "Error : SetMode requires system ≥ 6.0.5"
  29.      "Error : SetMode requires Color QuickDraw"
  30.      "Error : Missing or empty parameter(s)"
  31.      "Error : Mode param must be <B|C>"
  32.      "Error : Depth not available on device X"
  33.      "Error : Couldn't set depth on device X"
  34.      "Error : Device not found"
  35.  
  36. HISTORY
  37. 1.4                                                                                         02/25/94
  38. • Fixed current screen calculation
  39.                                                                                          
  40. 1.3                                                                                         03/04/92
  41. • Added 16 bits support (thousands of colors)
  42.                                                                                          
  43. 1.2
  44. • Fixed last minute bug
  45.                                                                                          
  46. 1.1
  47. • Screen garbage fixed when switching to 8bit, thanks to Bill Steinberg.
  48.                                                                                          
  49. This stack also uses GetMode XFCN, © Frederic RINALDI 1989…1993.
  50. --------------------------------------------------------------------
  51.    All externals included in this stack are FreeWare and may be used in non-commercial software provided the following notice is visibly present :
  52.  
  53.                    SetMode XCMD, © Frederic Rinaldi, 1989…1994.
  54.  
  55.    Free for non-commercial use. Use in commercial software subjected to prior acknowledgement and licensing from the author, reachable at the following network addresses:
  56.  
  57. AppleLink: RINALDI1   CalvaCom : FR10    Compuserve : 71170,2111
  58.                Internet : RINALDI1@APPLELINK.APPLE.COM